//****************************************************************************//
// Function Library for setting the Port Mapper
//    File: hal_pmap.c
//
//    Texas Instruments
//
//    Version 1.0
//    10/17/09
//
//    V1.0  Initial Version
//****************************************************************************//

/* ***********************************************************
* THIS PROGRAM IS PROVIDED "AS IS". TI MAKES NO WARRANTIES OR
* REPRESENTATIONS, EITHER EXPRESS, IMPLIED OR STATUTORY,
* INCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE, LACK OF VIRUSES, ACCURACY OR
* COMPLETENESS OF RESPONSES, RESULTS AND LACK OF NEGLIGENCE.
* TI DISCLAIMS ANY WARRANTY OF TITLE, QUIET ENJOYMENT, QUIET
* POSSESSION, AND NON-INFRINGEMENT OF ANY THIRD PARTY
* INTELLECTUAL PROPERTY RIGHTS WITH REGARD TO THE PROGRAM OR
* YOUR USE OF THE PROGRAM.
*
* IN NO EVENT SHALL TI BE LIABLE FOR ANY SPECIAL, INCIDENTAL,
* CONSEQUENTIAL OR INDIRECT DAMAGES, HOWEVER CAUSED, ON ANY
* THEORY OF LIABILITY AND WHETHER OR NOT TI HAS BEEN ADVISED
* OF THE POSSIBILITY OF SUCH DAMAGES, ARISING IN ANY WAY OUT
* OF THIS AGREEMENT, THE PROGRAM, OR YOUR USE OF THE PROGRAM.
* EXCLUDED DAMAGES INCLUDE, BUT ARE NOT LIMITED TO, COST OF
* REMOVAL OR REINSTALLATION, COMPUTER TIME, LABOR COSTS, LOSS
* OF GOODWILL, LOSS OF PROFITS, LOSS OF SAVINGS, OR LOSS OF
* USE OR INTERRUPTION OF BUSINESS. IN NO EVENT WILL TI'S
* AGGREGATE LIABILITY UNDER THIS AGREEMENT OR ARISING OUT OF
* YOUR USE OF THE PROGRAM EXCEED FIVE HUNDRED DOLLARS
* (U.S.$500).
*
* Unless otherwise stated, the Program written and copyrighted
* by Texas Instruments is distributed as "freeware".  You may,
* only under TI's copyright in the Program, use and modify the
* Program without any charge or restriction.  You may
* distribute to third parties, provided that you transfer a
* copy of this license to the third party and the third party
* agrees to these terms by its first use of the Program. You
* must reproduce the copyright notice and any other legend of
* ownership on each copy or partial copy, of the Program.
*
* You acknowledge and agree that the Program contains
* copyrighted material, trade secrets and other TI proprietary
* information and is protected by copyright laws,
* international copyright treaties, and trade secret laws, as
* well as other intellectual property laws.  To protect TI's
* rights in the Program, you agree not to decompile, reverse
* engineer, disassemble or otherwise translate any object code
* versions of the Program to a human-readable form.  You agree
* that in no event will you alter, remove or destroy any
* copyright notice included in the Program.  TI reserves all
* rights not specifically granted under this license. Except
* as specifically provided herein, nothing in this agreement
* shall be construed as conferring by implication, estoppel,
* or otherwise, upon you, any license or other right under any
* TI patents, copyrights or trade secrets.
*
* You may not use the Program in non-TI devices.
* ********************************************************* */

#include "msp430.h"
#include "hal_pmap.h" 

/* ***************************************************************************
 * configure_ports
 *  Configures the MSP430 Port Mapper
 *
 * \param *port_mapping:     Pointer to init Data
 * \param PxMAPy:            Pointer start of first Port Mapper to initialize
 * \param num_of_ports:      Number of Ports to initialize
 * \param port_map_reconfig: Flag to enable/disable reconfiguration
 *
*/
void configure_ports(const uint8_t * port_mapping, uint8_t * PxMAPy, 
                    uint8_t num_of_ports, uint8_t port_map_reconfig)
{
  uint16_t i;
  uint16_t globalInterruptState = __get_SR_register() & GIE;
  
  // Disable all interrupts
  __disable_interrupt();
  
  // Get write-access to port mapping registers:
  PMAPPWD = PMAPPW;
  
  if (port_map_reconfig)
  {
    // Allow reconfiguration during runtime:
    PMAPCTL = PMAPRECFG;
  }
  
  // Configure Port Mapping:
  for (i= 0; i<num_of_ports*8; i++)
  {
    PxMAPy[i]= port_mapping[i];
  }
  
  // Disable write-access to port mapping registers:
  PMAPPWD = 0;
  
  __bis_SR_register(globalInterruptState);
} // configure_ports()

